Skip to content

Conversation

@kashiif
Copy link
Contributor

@kashiif kashiif commented Sep 19, 2025

Description

Update example syntax for Express v5 that does not require body-parser package.

Checklist:

  • Issue Addressed: [ ]
  • Link to SAML spec: [ ]
  • Tests included? [ ]
  • Documentation updated? [X]

Summary by CodeRabbit

  • Documentation
    • Added Express compatibility guidance for authentication callbacks, covering both v4.x and v5.x versions with implementation examples.
    • Minor textual correction in changelog.

✏️ Tip: You can customize this high-level summary in your review settings.

markstos
markstos previously approved these changes Sep 23, 2025
Copy link
Contributor

@markstos markstos left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@github-actions
Copy link

This PR is stale because is has been open for 90 days with no activity.

@github-actions github-actions bot added the stale label Dec 23, 2025
@github-actions github-actions bot removed the stale label Jan 7, 2026
@coderabbitai
Copy link

coderabbitai bot commented Jan 9, 2026

📝 Walkthrough

Walkthrough

Pull request adds Express compatibility documentation to the README with examples for v4.x and v5.x, and makes a minor spacing correction in CHANGELOG.md. All changes are documentation-only with no functional code modifications.

Changes

Cohort / File(s) Summary
Documentation Updates
README.md
Added two new subsections under authentication callback section describing Express v4.x and v5.x compatibility requirements with code examples for middleware ordering.
Changelog Maintenance
CHANGELOG.md
Minor spacing correction: removed extra space after "v4." in the Major Changes Dependencies entry.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐰 A rabbit's note on docs so fine,
Express paths now aligned in line,
v4 and v5, both crystal clear,
Middleware order, never fear!
With spaces fixed and guides complete,
This changelog hopping feels so sweet!

🚥 Pre-merge checks | ✅ 2 | ❌ 1
❌ Failed checks (1 inconclusive)
Check name Status Explanation Resolution
Description check ❓ Inconclusive The description addresses the primary purpose of the changes but lacks detail on use-case, is missing a summary of changes, and has minimal checklist completion despite the template requirements. Add a more detailed summary of changes, explain the use-case for Express v5 compatibility, and consider completing additional checklist items if applicable.
✅ Passed checks (2 passed)
Check name Status Explanation
Title check ✅ Passed The title 'Update documentation for Express v5' directly summarizes the main change in the pull request, which adds Express v5 documentation.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In @CHANGELOG.md:
- Line 130: Wrap the bare URL in the CHANGELOG entry so it’s not a bare URL;
update the line containing the node-saml changelog link
(https://github.com/node-saml/node-saml/blob/master/CHANGELOG.md#v400-2022-10-28)
to enclose the URL in angle brackets like <https://...> to satisfy
MD034/no-bare-urls linting.
📜 Review details

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 9fcf3d2 and f49e57c.

📒 Files selected for processing (2)
  • CHANGELOG.md
  • README.md
🧰 Additional context used
🪛 markdownlint-cli2 (0.18.1)
CHANGELOG.md

130-130: Bare URL used

(MD034, no-bare-urls)

🔇 Additional comments (1)
README.md (1)

182-220: Clear and accurate Express v4.x / v5.x compatibility documentation.

The new subsections effectively document the differences between Express v4.x and v5.x for the authentication callback setup. Both code examples are syntactically correct and properly show the distinction: v4 requires the external body-parser package, while v5 has built-in urlencoded() middleware. The explanatory text is helpful for users upgrading or choosing between versions.

#### 💣 Major Changes

- deps: use node-saml v4. See node-saml changelog for breaking changes: https://github.com/node-saml/node-saml/blob/master/CHANGELOG.md#v400-2022-10-28 [#796](https://github.com/node-saml/passport-saml/pull/796)
- deps: use node-saml v4. See node-saml changelog for breaking changes: https://github.com/node-saml/node-saml/blob/master/CHANGELOG.md#v400-2022-10-28 [#796](https://github.com/node-saml/passport-saml/pull/796)
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Wrap bare URL in angle brackets to comply with markdown lint (MD034).

The bare URL should be wrapped in angle brackets: <https://github.com/node-saml/node-saml/blob/master/CHANGELOG.md#v400-2022-10-28> to satisfy the no-bare-urls linting rule.

📝 Proposed fix
- deps: use node-saml v4. See node-saml changelog for breaking changes: https://github.com/node-saml/node-saml/blob/master/CHANGELOG.md#v400-2022-10-28 [#796](https://github.com/node-saml/passport-saml/pull/796)
+ deps: use node-saml v4. See node-saml changelog for breaking changes: <https://github.com/node-saml/node-saml/blob/master/CHANGELOG.md#v400-2022-10-28> [#796](https://github.com/node-saml/passport-saml/pull/796)
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
- deps: use node-saml v4. See node-saml changelog for breaking changes: https://github.com/node-saml/node-saml/blob/master/CHANGELOG.md#v400-2022-10-28 [#796](https://github.com/node-saml/passport-saml/pull/796)
- deps: use node-saml v4. See node-saml changelog for breaking changes: <https://github.com/node-saml/node-saml/blob/master/CHANGELOG.md#v400-2022-10-28> [#796](https://github.com/node-saml/passport-saml/pull/796)
🧰 Tools
🪛 markdownlint-cli2 (0.18.1)

130-130: Bare URL used

(MD034, no-bare-urls)

🤖 Prompt for AI Agents
In @CHANGELOG.md at line 130, Wrap the bare URL in the CHANGELOG entry so it’s
not a bare URL; update the line containing the node-saml changelog link
(https://github.com/node-saml/node-saml/blob/master/CHANGELOG.md#v400-2022-10-28)
to enclose the URL in angle brackets like <https://...> to satisfy
MD034/no-bare-urls linting.

@markstos markstos merged commit 9623536 into node-saml:master Jan 9, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants